home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / unzip.1 < prev    next >
Text File  |  1995-07-25  |  13KB  |  331 lines
  1.  
  2.  
  3.  
  4.      UUUUNNNNZZZZIIIIPPPP((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22222222 AAAAuuuugggg 99992222 ((((vvvv5555....0000))))))))         UUUUNNNNZZZZIIIIPPPP((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           unzip - list/test/extract from a ZIP archive file
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           uuuunnnnzzzziiiipppp [ -ccccffffllllppppttttuuuuvvvvxxxxzzzz[aaaajjjjnnnnooooqqqqUUUUVVVV] ] _f_i_l_e[._z_i_p] [_f_i_l_e_s_p_e_c ...]
  13.  
  14.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  15.           _f_i_l_e[._z_i_p]  Path of the ZIP archive.  The suffix ``._z_i_p'' is
  16.                       applied if the _f_i_l_e specified does not exist.
  17.                       Note that self-extracting ZIP files are
  18.                       supported; just specify the ``._e_x_e'' suffix
  19.                       yourself.
  20.  
  21.           [_f_i_l_e_s_p_e_c]  An optional list of archive members to be
  22.                       processed.  Expressions may be used to match
  23.                       multiple members; be sure to quote expressions
  24.                       that contain characters interpreted by the
  25.                       operating system. See DESCRIPTION (below) for
  26.                       more details.
  27.  
  28.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  29.           -c  extract files to stdout/screen (``CRT'')
  30.           -f  freshen existing files (replace if newer); create none
  31.           -l  list archive files (short format)
  32.           -p  extract files to pipe; no informational messages
  33.           -t  test archive files
  34.           -u  update existing files; create new ones if needed
  35.           -v  list archive files (verbose format)
  36.           -x  extract files in archive (default)
  37.           -z  display only the archive comment
  38.  
  39.      MMMMOOOODDDDIIIIFFFFIIIIEEEERRRRSSSS
  40.           -a  convert to MS-DOS textfile format (CR LF), Mac format
  41.               (CR), Unix/VMS format (LF), OR from ASCII to EBCDIC,
  42.               depending on your system (only use for TEXT files!)
  43.           -j  junk paths (don't recreate archive's directory
  44.               structure)
  45.           -n  never overwrite existing files; don't prompt
  46.           -o  OK to overwrite files without prompting
  47.           -q  perform operations quietly (-qq => even quieter)
  48.           -s  [OS/2, MS-DOS] allow spaces in filenames (e.g.,
  49.               ``EA DATA. SF'')
  50.           -U  leave filenames uppercase if created under MS-DOS, VMS,
  51.               etc.
  52.           -V  retain (VMS) file version numbers
  53.           -X  [VMS] restore owner/protection info (may require
  54.               privileges)
  55.  
  56.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  57.           _U_n_Z_i_p will list, test, or extract from a ZIP archive,
  58.           commonly found on MSDOS systems.  Archive member extraction
  59.           is implied by the absence of the -c, -p, -t, -l, -v or -z
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/9/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      UUUUNNNNZZZZIIIIPPPP((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22222222 AAAAuuuugggg 99992222 ((((vvvv5555....0000))))))))         UUUUNNNNZZZZIIIIPPPP((((1111))))
  71.  
  72.  
  73.  
  74.           options.  All archive members are processed unless a
  75.           _f_i_l_e_s_p_e_c is provided to specify a subset of the archive
  76.           members.  The _f_i_l_e_s_p_e_c is similar to an egrep expression,
  77.           and may contain:
  78.  
  79.           *      matches a sequence of 0 or more characters
  80.           ?      matches exactly 1 character
  81.           \nnn   matches the character having octal code nnn
  82.           [...]  matches any single character found inside the
  83.                  brackets; ranges are specified by a beginning
  84.                  character, a hyphen, and an ending character.  If an
  85.                  exclamation point or a carat (`!' or `^') follows the
  86.                  left bracket, then the range of characters matched is
  87.                  complemented with respect to the ASCII character set
  88.                  (that is, anything except the characters inside the
  89.                  brackets is considered a match).
  90.  
  91.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT OOOOPPPPTTTTIIIIOOOONNNNSSSS
  92.           _U_n_Z_i_p's default behavior may be modified via options placed
  93.           in an environment variable.  This can be done with any
  94.           option, but it is probably most useful with the -q, -o, or
  95.           -n modifiers:  in order to make _U_n_Z_i_p quieter by default, or
  96.           to make it always overwrite or never overwrite files as it
  97.           extracts them.  For example, to make _U_n_Z_i_p act as quietly as
  98.           possible, only reporting errors, one would use one of the
  99.           following commands:
  100.  
  101.                 setenv UNZIP -qq           Unix C shell
  102.  
  103.                 UNZIP=-qq; export UNZIP    Unix Bourne shell
  104.  
  105.                 set UNZIP=-qq              OS/2 or MS-DOS
  106.  
  107.                 define UNZIP_OPTS "-qq"    VMS (quotes for LOWERCASE)
  108.  
  109.           Environment options are, in effect, considered to be just
  110.           like any other command-line options, except that they are
  111.           effectively the first options on the command line.  To
  112.           override an environment option, one may use the ``minus
  113.           operator'' to remove it.  For instance, to override one of
  114.           the quiet-flags in the example above, use the command
  115.  
  116.                 _u_n_z_i_p --q[other options] zipfile
  117.  
  118.           The first hyphen is the normal switch character, and the
  119.           second is a minus sign, acting on the q option.  Thus the
  120.           effect here is to cancel a single quantum of quietness.  To
  121.           cancel both quiet flags, two (or more) minuses may be used:
  122.  
  123.                 _u_n_z_i_p -x--q zipfile
  124.  
  125.           or
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/9/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      UUUUNNNNZZZZIIIIPPPP((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22222222 AAAAuuuugggg 99992222 ((((vvvv5555....0000))))))))         UUUUNNNNZZZZIIIIPPPP((((1111))))
  137.  
  138.  
  139.  
  140.                 _u_n_z_i_p ---qx zipfile
  141.  
  142.           (the two are equivalent).  This may seem awkward or
  143.           confusing, but it is reasonably intuitive:  just ignore the
  144.           first hyphen and go from there.  It is also consistent with
  145.           the behavior of Unix nice(1).
  146.  
  147.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  148.           To use _U_n_Z_i_p to extract all members of the archive
  149.           letters.zip, creating any directories as necessary:
  150.  
  151.                 _u_n_z_i_p letters
  152.  
  153.           To extract all members of letters.zip to the current
  154.           directory:
  155.  
  156.                 _u_n_z_i_p -j letters
  157.  
  158.           To test letters.zip, printing only a summary message
  159.           indicating whether the archive is OK or not:
  160.  
  161.                 _u_n_z_i_p -tq letters
  162.  
  163.           To extract to standard output all members of letters.zip
  164.           whose names end in ``.tex'', converting to the local end-
  165.           of-line convention and piping the output into more(1):
  166.  
  167.                 _u_n_z_i_p -ca letters \*.tex | more
  168.  
  169.           (The backslash before the asterisk is only required if the
  170.           shell expands wildcards, as in Unix; double quotes could
  171.           have been used instead, as in the source example below.)  To
  172.           extract the binary file paper1.dvi to standard output and
  173.           pipe it to a printing program:
  174.  
  175.                 _u_n_z_i_p -p articles paper1.dvi | dvips
  176.  
  177.           To extract all FORTRAN and C source files--*.f, *.c, *.h,
  178.           Makefile (the double quotes are necessary only in Unix and
  179.           only if globbing is turned on):
  180.  
  181.                 _u_n_z_i_p source.zip "*.[fch]" Makefile
  182.  
  183.           To extract only newer versions of the files already in the
  184.           current directory, without querying (NOTE:  be careful of
  185.           unzipping in one timezone a zipfile created in another--ZIP
  186.           archives contain no timezone information, and a ``newer''
  187.           file from an eastern timezone may, in fact, be older):
  188.  
  189.                 _u_n_z_i_p -fo sources
  190.  
  191.           To extract newer versions of the files already in the
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 3/9/94)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      UUUUNNNNZZZZIIIIPPPP((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22222222 AAAAuuuugggg 99992222 ((((vvvv5555....0000))))))))         UUUUNNNNZZZZIIIIPPPP((((1111))))
  203.  
  204.  
  205.  
  206.           current directory and to create any files not already there
  207.           (same caveat as previous example):
  208.  
  209.                 _u_n_z_i_p -uo sources
  210.  
  211.           In the last five examples, assume that UNZIP or UNZIP_OPTS
  212.           is set to -q.  To do a singly quiet listing:
  213.  
  214.                 _u_n_z_i_p -_l _f_i_l_e
  215.  
  216.           To do a doubly quiet listing:
  217.  
  218.                 _u_n_z_i_p -_q_l _f_i_l_e
  219.  
  220.           To do a standard listing:
  221.  
  222.                 _u_n_z_i_p --_q_l _f_i_l_e
  223.  
  224.           or
  225.  
  226.                 _u_n_z_i_p -_l-_q _f_i_l_e
  227.  
  228.           or
  229.  
  230.                 _u_n_z_i_p -_l--_q _f_i_l_e
  231.  
  232.           (extra minuses don't hurt).
  233.  
  234.      TTTTIIIIPPPPSSSS
  235.           The current maintainer, being a lazy sort, finds it very
  236.           useful to define an alias ``tt'' for ``unzip -tq''.  One may
  237.           then simply type ``tt zipfile'' to test the archive,
  238.           something which one ought make a habit of doing.  With luck
  239.           _U_n_Z_i_p will report ``No errors detected in zipfile.zip,''
  240.           after which one may breathe a sigh of relief.
  241.  
  242.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  243.           funzip(1), zip(1), zipcloak(1), zipinfo(1), zipnote(1),
  244.           zipsplit(1)
  245.  
  246.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  247.           Samuel H. Smith, Carl Mascott, David P. Kirschbaum, Greg R.
  248.           Roelofs, Mark Adler, Kai Uwe Rommel, Igor Mandrichenko,
  249.           Johnny Lee, Jean-loup Gailly; Glenn Andrews, Joel Aycock,
  250.           Allan Bjorklund, James Birdsall, Wim Bonner, John Cowan,
  251.           Frank da Cruz, Bill Davidsen, Arjan de Vet, James Dugal, Jim
  252.           Dumser, Mark Edwards, David Feinleib, Mike Freeman, Hunter
  253.           Goatley, Robert Heath, Dave Heiland, Larry Jones, Kjetil
  254.           J(o)rgenson, Bob Kemp, J. Kercheval, Alvin Koh, Bo Kullmar,
  255.           Johnny Lee, Warner Losh, Fulvio Marino, Gene McManus, Joe
  256.           Meadows, Mike O'Carroll, Humberto Ortiz-Zuazaga, Piet W.
  257.           Plomp, Antonio Querubin Jr., Steve Salisbury, Georg Sassen,
  258.  
  259.  
  260.  
  261.      Page 4                                           (printed 3/9/94)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      UUUUNNNNZZZZIIIIPPPP((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22222222 AAAAuuuugggg 99992222 ((((vvvv5555....0000))))))))         UUUUNNNNZZZZIIIIPPPP((((1111))))
  269.  
  270.  
  271.  
  272.           Jon Saxton, Hugh Schmidt, Martin Schulz, Charles Scripter,
  273.           Chris Seaman, Richard Seay, Alex Sergejew, Cliff Stanford,
  274.           Onno van der Linden, Jim Van Zandt, Antoine Verheijen, Paul
  275.           Wells.
  276.  
  277.      VVVVEEEERRRRSSSSIIIIOOOONNNNSSSS
  278.           v1.2  15 Mar 89  Samuel H. Smith
  279.           v2.0   9 Sep 89  Samuel H. Smith
  280.           v2.x  fall 1989  many Usenet contributors
  281.           v3.0   1 May 90  Info-ZIP (DPK, consolidator)
  282.           v3.1  15 Aug 90  Info-ZIP (DPK, consolidator)
  283.           v4.0   1 Dec 90  Info-ZIP (GRR, maintainer)
  284.           v4.1  12 May 91  Info-ZIP
  285.           v4.2  20 Mar 92  Info-ZIP (zip-bugs subgroup; GRR, maint.)
  286.           v5.0  21 Aug 92  Info-ZIP (zip-bugs subgroup; GRR, maint.)
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                           (printed 3/9/94)
  328.  
  329.  
  330.  
  331.